Gibt einen Wert vom Typ Variant (Integer) zurⁿck, der einen bestimmten Teil eines angegebenen Datums enthΣlt.
Syntax
DatePart(interval, date[,firstdayofweek[, firstweekofyear]])
Die Syntax fⁿr die DatePart-Funktion besteht aus folgenden benannten Argumenten:
| Teil | Beschreibung |
|---|---|
| interval | Erforderlich. Zeichenfolgenausdruck, der das zurⁿckzugebende Zeitintervall ergibt. |
| date | Erforderlich. Wert vom Typ Variant (Date), den Sie berechnen m÷chten. |
| firstdayofweek | Optional. Eine Konstante, die den ersten Tag der Woche angibt. Ist dieser Wert nicht angegeben, so wird Sonntag angenommen. |
| firstweekofyear | Optional. Eine Konstante, die die erste Woche des Jahres angibt. Ist dieser Wert nicht angegeben, wird die Woche mit dem 1. Januar als die erste Woche angenommen. |
Einstellungen
Das Argument interval hat folgende Einstellungen:
| Einstellung | Beschreibung |
|---|---|
| yyyy | Jahr |
| q | Quartal |
| m | Monat |
| y | Tag des Jahres |
| d | Tag |
| w | Wochentag |
| ww | Woche |
| h | Stunde |
| n | Minute |
| s | Sekunde |
Das Argument firstdayofweek hat folgende Einstellungen:
| Konstante | Wert | Beschreibung |
|---|---|---|
| vbUseSystem | 0 | Die NLS API-Einstellung wird verwendet. |
| vbSunday | 1 | Sonntag (Voreinstellung) |
| vbMonday | 2 | Montag |
| vbTuesday | 3 | Dienstag |
| vbWednesday | 4 | Mittwoch |
| vbThursday | 5 | Donnerstag |
| vbFriday | 6 | Freitag |
| vbSaturday | 7 | Samstag |
Das Argument firstweekofyear hat folgende Einstellungen:
| Konstante | Wert | Beschreibung |
|---|---|---|
| vbUseSystem | 0 | Die NLS API-Einstellung wird verwendet. |
| vbFirstJan1 | 1 | Anfang in der Woche mit dem 1. Januar (Voreinstellung) |
| vbFirstFourDays | 2 | Anfang in der ersten Woche, die mindestens vier Tage im neuen Jahr enthΣlt. |
| VbFirstFullWeek | 3 | Anfang in der ersten vollen Woche des Jahres. |
Bemerkungen
Mit der DatePart-Funktion k÷nnen Sie ein Datum auswerten und ein bestimmtes Zeitintervall zurⁿckgeben. Sie k÷nnen mit DatePart zum Beispiel den Tag der Woche oder die aktuelle Stunde berechnen.
Das Argument firstdayofweek betrifft Berechnungen, die die Intervallsymbole "w" und "ww" verwenden.
Entspricht Datum einem Datumsliteral, so wird das angegebene Jahr zu einem dauerhaften Bestandteil dieses Datums. Wird Datum jedoch in Anfⁿhrungszeichen ("") eingeschlossen und das Jahr nicht angegeben, so wird bei jeder Auswertung des Ausdrucks Datum das aktuelle Jahr in Ihren Code eingefⁿgt. Sie k÷nnen daher Code schreiben, der in mehreren Jahren verwendet werden kann.
Anmerkung Wenn die Einstellung der Calendar-Eigenschaft auf Gregorianisch steht, mu▀ das durch das Argument Datum angegebene Datum dem Gregorianischen Kalender entsprechen. Wenn die Eigenschaft auf Hijri steht, mu▀ das angegebene Datum dem Hijri-Kalender entsprechen.
Der zurⁿckgegebene Bestandteil des Datums befindet sich innerhalb der Zeitraumeinheiten des aktuellen Arabischen Kalenders. Wenn der aktuelle Kalender beispielsweise ein Hijri-Kalender ist und der Bestandteil des Datums, der zurⁿckgegeben werden soll, das Jahr, dann ist der Wert fⁿr Jahr ein Hijri-Jahr.